Preparing Servers for Monitoring

Oracle Enterprise Manager Cloud Control Plug-In for Oracle Hardware communicates with your target server's Oracle Integrated Lights Out Manager (ILOM) service processor for hardware inventory, health and configuration data. An IPMI interface is required between the host operating system and the server's service processor. By default this interface is configured on the following operating systems:

• Oracle Solaris 11

• Microsoft Windows Server 2008

On Linux based operating systems the IPMI interface might need to be configured manually. The following sections describe the configuration procedures you should follow on each server you want to monitor by enabling communication with the Oracle ILOM service processor.

Configuring the IPMI Interface (Linux)

For each server you want to monitor, an IPMI interface needs to be enabled in the running operating system. Processes that need to read from and write to the IPMI interface must run with administrator privileges. For security reasons, configuration of the sudo command is required on each server running Oracle Enterprise Manager Cloud Control Plug-In for Oracle Hardware.

Enabling the IPMI Interface

Before You Begin

You must have administrator privileges on the server to be able to follow this configuration procedure.

1. Enable the IPMI interface using the following command:

   # chkconfig --level 2345 ipmi on

   ---

   Note - After making this change, you might need to start or restart the IPMI service.

   ---

Configuring Administrator Privileges (UNIX)

Oracle Enterprise Manager Cloud Control Plug-In for Oracle Hardware contains a utility called hwmgmtcli that is responsible for getting information from the Oracle ILOM service processor. Running the hwmgmtcli utility on a the following operating systems requires configuration of sudo:

• Oracle Solaris

• Linux based operating systems

On servers running these operating systems, the Enterprise Management agent needs to be granted Administrator privileges so that the Oracle Enterprise Manager Cloud Control Plug-In for Oracle Hardware can successfully communicate with the Oracle ILOM service processor using the IPMI interface.

Granting Administrator Privileges

1. Open the sudoers file for editing. The sudoers file is usually found at /etc/sudoers.
2. Add the following line to the sudoers file:

   oracle ALL=(root) SETENV:AGENT_HOME/sbin/nmosudo *oracle ALL=(root) SETENV:AGENT_HOME/core/AGENT_VERSION/perl/bin/perlAGENT_HOME/core/AGENT_VERSION/../../plugins/oracle.sun.ossb.agent.plugin_12.1.0.4.0/scripts/emx/oracle_hardware/collect.pl *

   where AGENT_VERSION is the version number of Oracle Enterprise Manager agent you are using, for example 12.1.0.4.0, and where AGENT_HOME is the root directory of the Oracle Enterprise Manager agent installation.

   ---

   Note - If sudo is not correctly configured, or supplied with an incorrect password, collection of metrics might not function correctly.

   ---

Deploying the Plug-In to Enterprise Manager

Once you have configured your servers for monitoring, you download and then import Oracle Enterprise Manager Cloud Control Plug-In for Oracle Hardware to your Oracle Enterprise Manager management server. Then you deploy Oracle Enterprise Manager Cloud Control Plug-In for Oracle Hardware to the servers you want to monitor.

The latest version of Oracle Enterprise Manager Cloud Control Plug-In for Oracle Hardware is available from:

http://www.oracle.com/goto/em-hw-plugin

The following procedures explain how to import and deploy Oracle Enterprise Manager Cloud Control Plug-In for Oracle Hardware. For more information on this process, see your Oracle Enterprise Manager documentation for details on Importing an External Archive into Enterprise Manager.

Importing the Plug-in to your Management Server

Before You Begin

• You must configure the servers you want to monitor before deploying Oracle Enterprise Manager Cloud Control Plug-In for Oracle Hardware. See Preparing Servers for Monitoring.

• You must have administrator rights on your Oracle Enterprise Manager management server to deploy the Oracle Enterprise Manager Cloud Control Plug-In for Oracle Hardware.

• You must be able to access the emcli command, installed by default to the bin directory inside the Oracle Enterprise Manager install directory.

1. Copy the file you have downloaded to your Oracle Enterprise Manager management server.
2. Use the emcli command to log in to the Oracle Enterprise Manager management server as the sysman user:

   emcli login -username="sysman"

   When prompted, provide the password for the sysman user.

3. Use the emcli command to import Oracle Enterprise Manager Cloud Control Plug-In for Oracle Hardware:

   emcli import_update -file="path/plug-in_version_oracle.sun.ossb_2000_0.opar" -omslocal

   where path is the path to the file you saved in step 1, and plug-in_version is the version number of the plug-in, for example 12.1.0.4.0.

   Oracle Enterprise Manager Cloud Control Plug-In for Oracle Hardware is imported to your Oracle Enterprise Manager management server.

Deploying the Plug-in to your Oracle Enterprise Manager Management Server

Before You Begin

• You must import the Oracle Enterprise Manager Cloud Control Plug-In for Oracle Hardware before following this procedure. See Importing the Plug-in to your Management Server.

1. Log in to the Oracle Enterprise Manager management server as an administrator. In the Setup menu, click Extensibility, and then click Plug-ins.
2. In the list of plug-ins, open the Servers, Storage and Network section, then click Oracle Hardware Plug-in.

   The Deploy On button becomes activated.

3. From the Deploy On button's drop-down menu, click Management Server.

   The Deploy Plug-in on Management Servers dialog box opens.

4. Click Add.

   The Search and Select: Targets window opens.

5. Choose one of the following options:
   • If the server you want to deploy to is listed in the Search and Select: Targets window, click the server's row and then click Select.
   • If the server you want to deploy to is not listed in the Search and Select: Targets window, use the search at the top of the window. When the server is listed, click the server's row and then click Select.
6. Type the Repository SYS password and click Continue.

   Oracle Hardware Plug-in is installed to your Management Server.

Deploying the Plug-in to your Servers

Once you have deployed the Plug-in to your EM Management Server, you deploy the Plug-in to the EM Management Agent running on each target server. In addition, you must configure Privilege Delegation on each target server running the following UNIX based operating systems:

• Oracle Solaris

• Linux based operating systems

Privilege Delegation Configuration (UNIX)

The following procedure is necessary only for target servers running UNIX based operating systems.

1. Log in to the Oracle Enterprise Manager management server as an administrator. Go to Setup, select Security and then Privilege Delegation.
2. For each target you want to monitor, click on the pencil to edit the configuration.

   The target's configuration settings open.

3. Select the sudo radio button. Then set the Sudo Command field to:

   path/sudo -E -u %RUNAS% %COMMAND%

   where path is the path to the sudo binary on the target.

4. Click the Update button.

   The changes to the target's configuration are saved.

5. Repeat this process for each target you want to monitor.

Deploying the Plug-in

Before You Begin

• You must deploy the Plug-in to your Oracle Enterprise Manager management server before following this procedure. See Deploying the Plug-in to your Oracle Enterprise Manager Management Server.

1. Log in to the Oracle Enterprise Manager management server as an administrator. In the Setup menu, click Extensibility, and then click Plug-ins.

   The Plug-in Updates screen opens.

2. From the Deploy On button's drop-down menu, click Management Agent.

   The Deploy Plug-in on Management Agent Window opens.

3. Click Add.

   The Search and Select: Targets window opens.

4. Choose one of the following options:
   • If the server you want to deploy to is listed in the Search and Select: Targets window, click the server's row and then click Select.
   • If the server you want to deploy to is not listed in the Search and Select: Targets window, use the Target Name and On Host text boxes to search for a target server. When the server is listed, click the server's row and then click Select.
5. Click Continue.

   Oracle Enterprise Manager Cloud Control Plug-In for Oracle Hardware is deployed to the selected server.

6. Repeat this procedure for each of the servers you want to monitor in Oracle Enterprise Manager.

Creating Oracle Hardware System Targets for Monitored Servers

Once you have deployed Oracle Enterprise Manager Cloud Control Plug-In for Oracle Hardware to your servers, you create Oracle Hardware System targets for the servers. Repeat the following procedure of creating Oracle Hardware System targets for every target server you want to monitor.

1. Log in to the Oracle Enterprise Manager management server as an administrator.
2. Click Setup, select Add Target, then click Add Targets Manually.
3. Under Add Targets Manually, select Add Non-Host Targets by Specifying Target Monitoring (the third option).
4. In the Target Type drop-down menu, select Oracle Hardware System.
5. In the Monitoring Agent section, click the magnifying glass.

   The Search and Select: Targets window opens.

6. Choose one of the following options:
   • If the target server you want to monitor is listed in the Search and Select: Targets window, click the server's row and then click Select.
   • If the target server you want to monitor is not listed in the Search and Select: Targets window, use the search at the top of the window. When the server is listed, click the server's row and then click Select.
7. With the target server you want to add listed in the Monitoring Agent text box, click Add Manually.

   The Add Oracle Hardware System page opens.

8. Type the name and the monitoring credentials for the Enterprise Manager agent of the hardware system being added.
9. On a UNIX based operating system, from the Run Privilege drop-down menu, select Sudo. Type the user that has the appropriate privileges in the Run as field, for example root.

   ---

   Note - If you encounter problems with Privilege Delegation Providers, see Privilege Delegation Configuration (UNIX).

   ---

10. Click OK.

Undeploying the Plug-In

The process of undeploying Oracle Enterprise Manager Cloud Control Plug-In for Oracle Hardware consists of reversing the steps taken during installation and removing the Oracle Enterprise Manager Cloud Control Plug-In for Oracle Hardware from your Oracle Enterprise Manager management server and monitored servers.

Removing Oracle Enterprise Manager Cloud Control Plug-In for Oracle Hardware

Before You Begin

• You must have administrator rights on your Oracle Enterprise Manager management server.

• You must undeploy Oracle Hardware Plug-in from all server management agents before undeploying from the Oracle Enterprise Manager management server.

1. Log in to the Oracle Enterprise Manager management server.
2. In the Setup menu, select Extensibility and then click Plug-ins.

   The Plug-ins page opens.

3. In the list of plug-ins, click Oracle Hardware Plug-in.

   The Oracle Hardware Plug-in row becomes selected.

4. From the Undeploy From drop-down menu, click Management Agent.

   The Undeploy Plug-in From Management Agent page opens.

5. Click Add.

   The Search and Select: Targets window opens.

6. Choose one of the following options:
   • If the server you want to undeploy from is listed in the Search and Select: Targets window, click the server's row and then click Select.
   • If the server you want to undeploy from monitor is not listed in the Search and Select: Targets window, use the search at the top of the window. When the server is listed, click the server's row and then click Select.
7. Click Select.

   The selected target is listed in the Undeploy Plug-in From Management Agent page.

8. Click Continue, then Next and finally Undeploy.

   The Oracle Hardware Plug-in is undeployed from the target server.

9. Repeat Steps 4 to 8 for each Management Agent server where you had Oracle Hardware Plug-in deployed.
10. Repeat Steps 4 to 8 for Oracle Enterprise Manager management server where you had Oracle Hardware Plug-in deployed.